IRIX Base Documentation 2002 November/SGI IRIX Base Documentation 2002 November.iso/usr/share/catman/a_man/cat1/colltbl.z/colltbl

Text File | 2002-10-03 | 17.4 KB | 264 lines

ccccoooollllllllttttbbbbllll((((1111MMMM))))                                                        ccccoooollllllllttttbbbbllll((((1111MMMM))))



NNNNAAAAMMMMEEEE
     _cccc_oooo_llll_llll_tttt_bbbb_llll - create collation database

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     _cccc_oooo_llll_llll_tttt_bbbb_llll [ _f_i_l_e | _---- ]

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     The _cccc_oooo_llll_llll_tttt_bbbb_llll command takes as input a specification file, _f_i_l_e, that
     describes the collating sequence for a particular language and creates a
     database that can be read by _ssss_tttt_rrrr_xxxx_ffff_rrrr_mmmm(3C) and _ssss_tttt_rrrr_cccc_oooo_llll_llll(3C).  _ssss_tttt_rrrr_xxxx_ffff_rrrr_mmmm(3C)
     transforms its first argument and places the result in its second
     argument.  The transformed string is such that it can be correctly
     ordered with other transformed strings by using _ssss_tttt_rrrr_cccc_mmmm_pppp(3C), _ssss_tttt_rrrr_nnnn_cccc_mmmm_pppp(3C),
     or _mmmm_eeee_mmmm_cccc_mmmm_pppp(3C).  _ssss_tttt_rrrr_cccc_oooo_llll_llll(3C) transforms its arguments and does a
     comparison.

     If no input file is supplied, _s_t_d_i_n is read.

     The output file produced contains the database with collating sequence
     information in a form usable by system commands and routines.  The name
     of this output file is the value you assign to the keyword _cccc_oooo_dddd_eeee_ssss_eeee_tttt read
     in from _f_i_l_e.  Before this file can be used, it must be installed in the
     _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_llll_oooo_cccc_aaaa_llll_eeee/_l_o_c_a_l_e directory with the name _LLLL_CCCC______CCCC_OOOO_LLLL_LLLL_AAAA_TTTT_EEEE by someone who
     is super-user or a member of group _bbbb_iiii_nnnn.  _l_o_c_a_l_e corresponds to the
     language area whose collation sequence is described in _f_i_l_e.  This file
     must be readable by user, group, and other; no other permissions should
     be set.  To use the collating sequence information in this file, set the
     _LLLL_CCCC______CCCC_OOOO_LLLL_LLLL_AAAA_TTTT_EEEE environment variable appropriately [see _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn(5) or
     _ssss_eeee_tttt_llll_oooo_cccc_aaaa_llll_eeee(3C)].

     The _cccc_oooo_llll_llll_tttt_bbbb_llll command can support languages whose collating sequence can be
     completely described by the following cases:

     +o   Ordering of single characters within the code set.  For example, in
         Swedish, _VVVV is sorted after _UUUU, before _XXXX, and with _WWWW (_VVVV and _WWWW are
         considered identical as far as sorting is concerned).

     +o   Ordering of ``double characters'' in the collation sequence.  For
         example, in Spanish, _cccc_hhhh and _llll_llll are collated after _cccc and _llll,
         respectively.

     +o   Ordering of a single character as if it consists of two characters.
         For example, in German, the ``sharp s,'' _BBBB, is sorted as _ssss_ssss.  This is
         a special instance of the next case below.

     +o   Substitution of one character string with another character string.
         In the example above, the string _BBBB is replaced with _ssss_ssss during
         sorting.

     +o   Ignoring certain characters in the code set during collation.  For
         example, if _---- were ignored during collation, then the strings
         _rrrr_eeee_----_llll_oooo_cccc_aaaa_tttt_eeee and _rrrr_eeee_llll_oooo_cccc_aaaa_tttt_eeee would compare as equal.



                                                                        PPPPaaaaggggeeee 1111






ccccoooollllllllttttbbbbllll((((1111MMMM))))                                                        ccccoooollllllllttttbbbbllll((((1111MMMM))))



     +o   Secondary ordering between characters.  In the case where two
         characters are sorted together in the collation sequence, (that is,
         they have the same "primary" ordering), there is sometimes a
         secondary ordering that is used if two strings are identical except
         for characters that have the same primary ordering.  For example, in
         French, the letters _eeee and _eeee_```` have the same primary ordering but _eeee
         comes before _eeee_```` in the secondary ordering.  Thus the word _llll_eeee_vvvv_eeee_rrrr would
         be ordered before _llll_eeee_````_vvvv_eeee_rrrr, but _llll_eeee_````_vvvv_eeee_rrrr would be sorted before _llll_eeee_vvvv_iiii_tttt_aaaa_tttt_eeee.
         (Note that if _eeee came before _eeee_```` in the primary ordering, then _llll_eeee_````_vvvv_eeee_rrrr
         would be sorted after _llll_eeee_vvvv_iiii_tttt_aaaa_tttt_eeee.)

     The specification file consists of three types of statements:

     1.  _cccc_oooo_dddd_eeee_ssss_eeee_tttt   _f_i_l_e_n_a_m_e

         _f_i_l_e_n_a_m_e is the name of the output file to be created by _cccc_oooo_llll_llll_tttt_bbbb_llll.

     2.  _oooo_rrrr_dddd_eeee_rrrr _iiii_ssss  _o_r_d_e_r__l_i_s_t

         _o_r_d_e_r__l_i_s_t is a list of symbols, separated by semicolons, that
         defines the collating sequence.  The special symbol, _...._...._...., specifies
         symbols that are lexically sequential in a short-hand form.  For
         example,
              _oooo_rrrr_dddd_eeee_rrrr _iiii_ssss  _aaaa_;;;;_bbbb_;;;;_cccc_;;;;_dddd_;;;;_...._...._...._;;;;_xxxx_;;;;_yyyy_;;;;_zzzz

         would specify the list of lowercase letters.  Of course, this could
         be further compressed to just _aaaa_;;;;_...._...._...._;;;;_zzzz.

         A symbol can be up to two bytes in length and can be represented in
         any one of the following ways:

         +o   the symbol itself (for example, _aaaa for the lowercase letter _aaaa),

         +o   in octal representation (for example, _\\\\_1111_4444_1111 or _0000_1111_4444_1111 for the letter
             _aaaa), or

         +o   in hexadecimal representation (for example, _\\\\_xxxx_6666_1111 or _0000_xxxx_6666_1111 for the
             letter _aaaa).

         Any combination of these may be used as well.

         The backslash character, _\\\\ , is used for continuation.  No characters
         are permitted after the backslash character.

         Symbols enclosed in parentheses are assigned the same primary
         ordering but different secondary ordering.  Symbols enclosed in curly
         brackets are assigned only the same primary ordering.  For example,


              _oooo_rrrr_dddd_eeee_rrrr _iiii_ssss  _aaaa_;;;;_bbbb_;;;;_cccc_;;;;_cccc_hhhh_;;;;_dddd_;;;;_((((_eeee_;;;;_eeee_````_))))_;;;;_ffff_;;;;_...._...._...._;;;;_zzzz_;;;;_\\\\
                        _{{{{_1111_;;;;_...._...._...._;;;;_9999_}}}}_;;;;_AAAA_;;;;_...._...._...._;;;;_ZZZZ




                                                                        PPPPaaaaggggeeee 2222






ccccoooollllllllttttbbbbllll((((1111MMMM))))                                                        ccccoooollllllllttttbbbbllll((((1111MMMM))))



         In the above example, _eeee and _eeee_```` are assigned the same primary ordering
         and different secondary ordering, digits 1 through 9 are assigned the
         same primary ordering and no secondary ordering.  Only primary
         ordering is assigned to the remaining symbols.  Notice how double
         letters can be specified in the collating sequence (letter _cccc_hhhh comes
         between _cccc and _dddd).

         If a character is not included in the _oooo_rrrr_dddd_eeee_rrrr _iiii_ssss statement, it is
         excluded from the ordering and will be ignored during sorting.

     3.  _ssss_uuuu_bbbb_ssss_tttt_iiii_tttt_uuuu_tttt_eeee _s_t_r_i_n_g _wwww_iiii_tttt_hhhh _r_e_p_l

         The _ssss_uuuu_bbbb_ssss_tttt_iiii_tttt_uuuu_tttt_eeee statement substitutes the string _s_t_r_i_n_g with the
         string _r_e_p_l.  This can be used, for example, to provide rules to sort
         the abbreviated month names numerically:


              _ssss_uuuu_bbbb_ssss_tttt_iiii_tttt_uuuu_tttt_eeee _""""_JJJJ_aaaa_nnnn_"""" _wwww_iiii_tttt_hhhh _""""_0000_1111_""""
              _ssss_uuuu_bbbb_ssss_tttt_iiii_tttt_uuuu_tttt_eeee _""""_FFFF_eeee_bbbb_"""" _wwww_iiii_tttt_hhhh _""""_0000_2222_""""
                   _....
                   _....
                   _....
              _ssss_uuuu_bbbb_ssss_tttt_iiii_tttt_uuuu_tttt_eeee _""""_DDDD_eeee_cccc_"""" _wwww_iiii_tttt_hhhh _""""_1111_2222_""""

         A simpler use of the _ssss_uuuu_bbbb_ssss_tttt_iiii_tttt_uuuu_tttt_eeee statement would be to substitute a
         single character with two characters, as with the substitution of _BBBB
         with _ssss_ssss in German.

     The _ssss_uuuu_bbbb_ssss_tttt_iiii_tttt_uuuu_tttt_eeee statement is optional.  The _oooo_rrrr_dddd_eeee_rrrr _iiii_ssss and _cccc_oooo_dddd_eeee_ssss_eeee_tttt
     statements must appear in the specification file.

     Any lines in the specification file with a _#### in the first column are
     treated as comments and are ignored.  Empty lines are also ignored.

EEEEXXXXAAAAMMMMPPPPLLLLEEEE
     The following example shows the collation specification required to
     support a hypothetical telephone book sorting sequence.

     The sorting sequence is defined by the following rules:

     a.Upper- and lowercase letters must be sorted together, but uppercase
       letters have precedence over lowercase letters.

     b.All special characters and punctuation should be ignored.

     c.Digits must be sorted as their alphabetic counterparts (for example, _0000
       as _zzzz_eeee_rrrr_oooo, _1111 as _oooo_nnnn_eeee).

     d.The _CCCC_hhhh, _cccc_hhhh, _CCCC_HHHH combinations must be collated between _CCCC and _DDDD.






                                                                        PPPPaaaaggggeeee 3333






ccccoooollllllllttttbbbbllll((((1111MMMM))))                                                        ccccoooollllllllttttbbbbllll((((1111MMMM))))



     e._VVVV and _WWWW, _vvvv and _wwww must be collated together.

     The input specification file to _cccc_oooo_llll_llll_tttt_bbbb_llll will contain:


               _cccc_oooo_dddd_eeee_ssss_eeee_tttt   _tttt_eeee_llll_eeee_pppp_hhhh_oooo_nnnn_eeee
               _oooo_rrrr_dddd_eeee_rrrr _iiii_ssss  _AAAA_;;;;_aaaa_;;;;_BBBB_;;;;_bbbb_;;;;_CCCC_;;;;_cccc_;;;;_CCCC_HHHH_;;;;_CCCC_hhhh_;;;;_cccc_hhhh_;;;;_DDDD_;;;;_dddd_;;;;_EEEE_;;;;_eeee_;;;;_FFFF_;;;;_ffff_;;;;_\\\\
                         _GGGG_;;;;_gggg_;;;;_HHHH_;;;;_hhhh_::::_IIII_;;;;_iiii_;;;;_JJJJ_;;;;_jjjj_;;;;_KKKK_;;;;_kkkk_;;;;_LLLL_;;;;_llll_;;;;_MMMM_;;;;_mmmm_;;;;_NNNN_;;;;_nnnn_;;;;_OOOO_;;;;_oooo_;;;;_PPPP_;;;;_pppp_;;;;_\\\\
                         _QQQQ_;;;;_qqqq_;;;;_RRRR_;;;;_rrrr_;;;;_SSSS_;;;;_ssss_;;;;_TTTT_;;;;_tttt_;;;;_UUUU_;;;;_uuuu_;;;;_{{{{_VVVV_;;;;_WWWW_}}}}_;;;;_{{{{_vvvv_;;;;_wwww_}}}}_;;;;_XXXX_;;;;_xxxx_;;;;_YYYY_;;;;_yyyy_;;;;_ZZZZ_;;;;_zzzz
               _ssss_uuuu_bbbb_ssss_tttt_iiii_tttt_uuuu_tttt_eeee _""""_0000_"""" _wwww_iiii_tttt_hhhh _""""_zzzz_eeee_rrrr_oooo_""""
               _ssss_uuuu_bbbb_ssss_tttt_iiii_tttt_uuuu_tttt_eeee _""""_1111_"""" _wwww_iiii_tttt_hhhh _""""_oooo_nnnn_eeee_""""
               _ssss_uuuu_bbbb_ssss_tttt_iiii_tttt_uuuu_tttt_eeee _""""_2222_"""" _wwww_iiii_tttt_hhhh _""""_tttt_wwww_oooo_""""
               _ssss_uuuu_bbbb_ssss_tttt_iiii_tttt_uuuu_tttt_eeee _""""_3333_"""" _wwww_iiii_tttt_hhhh _""""_tttt_hhhh_rrrr_eeee_eeee_""""
               _ssss_uuuu_bbbb_ssss_tttt_iiii_tttt_uuuu_tttt_eeee _""""_4444_"""" _wwww_iiii_tttt_hhhh _""""_ffff_oooo_uuuu_rrrr_""""
               _ssss_uuuu_bbbb_ssss_tttt_iiii_tttt_uuuu_tttt_eeee _""""_5555_"""" _wwww_iiii_tttt_hhhh _""""_ffff_iiii_vvvv_eeee_""""
               _ssss_uuuu_bbbb_ssss_tttt_iiii_tttt_uuuu_tttt_eeee _""""_6666_"""" _wwww_iiii_tttt_hhhh _""""_ssss_iiii_xxxx_""""
               _ssss_uuuu_bbbb_ssss_tttt_iiii_tttt_uuuu_tttt_eeee _""""_7777_"""" _wwww_iiii_tttt_hhhh _""""_ssss_eeee_vvvv_eeee_nnnn_""""
               _ssss_uuuu_bbbb_ssss_tttt_iiii_tttt_uuuu_tttt_eeee _""""_8888_"""" _wwww_iiii_tttt_hhhh _""""_eeee_iiii_gggg_hhhh_tttt_""""
               _ssss_uuuu_bbbb_ssss_tttt_iiii_tttt_uuuu_tttt_eeee _""""_9999_"""" _wwww_iiii_tttt_hhhh _""""_nnnn_iiii_nnnn_eeee_""""

FFFFIIIILLLLEEEESSSS
     _////_llll_iiii_bbbb_////_llll_oooo_cccc_aaaa_llll_eeee_////_l_o_c_a_l_e_////_LLLL_CCCC______CCCC_OOOO_LLLL_LLLL_AAAA_TTTT_EEEE
                     _LLLL_CCCC______CCCC_OOOO_LLLL_LLLL_AAAA_TTTT_EEEE database for _l_o_c_a_l_e

     _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_llll_oooo_cccc_aaaa_llll_eeee_////_CCCC_////_cccc_oooo_llll_llll_tttt_bbbb_llll______CCCC
                     input file used to construct _LLLL_CCCC______CCCC_OOOO_LLLL_LLLL_AAAA_TTTT_EEEE in the default
                     locale.

SSSSEEEEEEEE AAAALLLLSSSSOOOO
     _mmmm_eeee_mmmm_oooo_rrrr_yyyy(3C), _ssss_eeee_tttt_llll_oooo_cccc_aaaa_llll_eeee(3C), _ssss_tttt_rrrr_cccc_oooo_llll_llll(3C), _ssss_tttt_rrrr_iiii_nnnn_gggg(3C), _ssss_tttt_rrrr_xxxx_ffff_rrrr_mmmm(3C),
     _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn(5)























                                                                        PPPPaaaaggggeeee 4444